Add a note about hook setup. (#425004, Emmanuele Bassi)

2007-11-26  Matthias Clasen  <mclasen@redhat.com>

        * gtk/gtkaboutdialog.c (gtk_about_dialog_set_website): Add a note
        about hook setup.  (#425004, Emmanuele Bassi)

svn path=/trunk/; revision=19050

diff --git a/ChangeLog b/ChangeLog
index fc871de6f1b100985049556fc4cb12326c8caa4f..dabcc8e15e7e3ed61712c2f71285001fed2ea603 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-11-26  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtkaboutdialog.c (gtk_about_dialog_set_website): Add a note
+       about hook setup.  (#425004, Emmanuele Bassi)
+
 2007-11-26  Tor Lillqvist  <tml@novell.com>
 
        * gdk/win32/gdkwindow-win32.c (gdk_window_fullscreen): Use the

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 60d4a913f131b36b2e248984f12fe68cb01e7a02..f27d5c06f05eb9a53044fd48566f581c5d6df251 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2007-11-26  Matthias Clasen <mclasen@redhat.com>
+
+       * gtk/tmpl/gtkaboutdialog.sgml: Add note about hook setup 
+       to the introduction.
+
 2007-11-25  Matthias Clasen <mclasen@redhat.com>
 
        * gtk/tmpl/gtkdialog.sgml: Move signal docs inline.

diff --git a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
index 4cb3fb7fc56cb5f039adc48b3809529831a30e65..ebecec0b4e98baa3a1a6af611befa2f004d4e22a 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
@@ -23,6 +23,19 @@ authors, documenters and artists properties are recognized by looking for
 recognized by looking for <literal>http://url</literal>, with 
 <literal>url</literal> extending to the next space, tab or line break.
 </para>
+<para id="gtk-about-dialog-hook-setup">
+When setting the website and email hooks for the #GtkAboutDialog widget, 
+you should remember that the order is important: you should set the hook 
+functions before setting the website and email URL properties, like this:
+</para>
+<informalexample><programlisting>
+gtk_about_dialog_set_url_hook (GTK_ABOUT_DIALOG (dialog), launch_url, NULL, NULL);
+gtk_about_dialog_set_website (GTK_ABOUT_DIALOG (dialog), app_url);
+</programlisting></informalexample>
+<para>
+Otherwise the GtkAboutDialog widget will not display the website and the 
+email addresses as clickable.
+</para>
 <para>
 To make constructing a #GtkAboutDialog as convenient as possible, you can
 use the function gtk_show_about_dialog() which constructs and shows a dialog 

diff --git a/gtk/gtkaboutdialog.c b/gtk/gtkaboutdialog.c
index 8af1c1b2d6aa4bc2f6115bb05d994f8e789322fe..540546aab7409b6f50c2bceb7a1db9fc2c1a24e2 100644 (file)
--- a/gtk/gtkaboutdialog.c
+++ b/gtk/gtkaboutdialog.c
@@ -1125,6 +1125,9 @@ gtk_about_dialog_get_website (GtkAboutDialog *about)
  * 
  * Sets the URL to use for the website link.
  *
+ * Note that that the hook functions need to be set up
+ * before calling this function.
+ *
  * Since: 2.6
  **/
 void